Skip to content

docs(roadmap): sync to v2.4.1 + operation-registry engine seam (§5.13)#44

Merged
bntvllnt merged 1 commit into
mainfrom
docs/roadmap-sync-v2.4.1
Jun 10, 2026
Merged

docs(roadmap): sync to v2.4.1 + operation-registry engine seam (§5.13)#44
bntvllnt merged 1 commit into
mainfrom
docs/roadmap-sync-v2.4.1

Conversation

@bntvllnt

Copy link
Copy Markdown
Owner

What

Docs only — brings roadmap.md back in line with shipped reality and records the 2026-06-10 architecture sweep findings as a roadmap item.

  • Header: Last updated: 2026-06-10 · shipped through v2.4.1 + rules engine (#42)
  • §2 baseline sync: check added to the command list; new Shipped since block covering feat(init): opt-in agent selection with interactive picker #36feat(rules): config + ESLint-style rules engine with check command #42 (config + ESLint-style rules engine foundation, init opt-in agent selection)
  • New §5.13 — Operation registry, one engine N surfaces (P1): the 15 analysis operations are exposed twice (CLI + MCP) with their lifecycle (validation, error routing, hints, serialization, graph-load) smeared across cli.ts / mcp/index.ts / src/core. Proposal: one Operation<TInput, TResult> descriptor per op (zod schema feeding both surfaces, result/error union, hints, formatter) with CLI/MCP as thin adapters — the same registry shape src/rules/ paved in feat(rules): config + ESLint-style rules engine with check command #42.
  • §6 sequencing: §5.13 slotted in P1 before §5.7, since output formats (SARIF/CodeClimate/…) become formatters over the registry, and the §5.12 LSP becomes a third thin adapter.

Evidence (self-analysis, graph-backed)

Signal Value
cli.ts 1205 LOC, fan-in 0 / fan-out 13, coupling 0.93 (top hotspot)
mcp/index.ts 446 LOC, cohesion 0.17 (JUNK_DRAWER)
Validation duplicated: parseInt+isNaN guards (CLI) vs zod (MCP)
Graph-load pipeline duplicated verbatim: loadGraph vs runMcpMode in cli.ts
Precedent src/rules/ registry: cohesion 0.71, COHESIVE

Why

The roadmap predates #41/#42, so it didn't answer "where are we" — and the sweep's keystone finding belongs on the direction file, not in a chat log.

…(§5.13)

- Stamp header with last-updated date and shipped-through marker
- Sync §2 baseline: add check command + shipped block for #36#42
  (config + rules engine foundation, init opt-in agent selection)
- Add §5.13 Operation registry (P1): one Operation<TInput,TResult>
  descriptor per analysis op, CLI/MCP as thin adapters — evidence from
  2026-06-10 self-analysis sweep (cli.ts coupling 0.93, mcp cohesion 0.17,
  duplicated validation/error/hints/graph-load). Enabler for §5.7 output
  formats and §5.12 LSP.
- Sequence §5.13 in P1 before output formats
@bntvllnt bntvllnt merged commit 3f09767 into main Jun 10, 2026
2 checks passed
@bntvllnt bntvllnt deleted the docs/roadmap-sync-v2.4.1 branch June 10, 2026 13:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant